home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / amiex / thrashtop.lha / ThrashTop / TTop1.5.Dox < prev   
Text File  |  1980-10-04  |  11KB  |  232 lines
  1.                                _  _ __\/__ _  _
  2.            __________________________ /\ _____________________
  3.           / ________________________// //____________________ \
  4.           \ \_ __ _____ __ ______   / / __ ____   __   __   / /
  5.            \_//  \\___//  \\____ \ / /_/ //___ \ /  \  \ \ / /
  6.              / /\ \   / /\ \   / // __  //   __// /\ \  \ V /
  7.          __ / /__\ \ / /  \ \ / // / / // /\ \ / /__\ \ / A \
  8.          \// //____//_/    \_\\// / /_//_/  \ \\______//_/ \ \
  9.           / /_________________ / /___________\ \ ___________\ \
  10.           \___________________\\//___________\\//_____________/
  11.  
  12.           ThrashTop V1.04 (C) 1992 Thrash/Anthrox
  13.  
  14.           THIS UTILITY CANNOT BE SOLD IN ANY FORM
  15.             BY PUBLIC DOMAIN LIBRARIES!
  16.  
  17.     Code, Commandline, Extra Ideas, Sheep ......... Thrash
  18.     Design, Additions, Ideas, Hastles to coder .... Pot-Noodle & Marvin
  19.     Dox/Help Text ................................. Thrash & Pot-Noodle
  20.  
  21.         SEE BOTTOM OF FILE FOR LATEST INFORMATION
  22.  
  23.     If you want to see ▀eta-Versions of up and coming Thrash utils
  24.     why not call one of the following boards. Thanks to all these
  25.     for thoroughly testing all my utils.
  26.  
  27.     BBS        NUMBER            Sysop
  28.  
  29.         C.A.L        +44-(0)81-3466842    Pot-Noodle
  30.     Synergy        +49-573141982        Sigma-Seven
  31.     Bad Dreams    +44-(0)81-6795693    Dream Warrior
  32.     HyperSpace    +49-59164755        Thargoid
  33.     Burger Bar    +44-(0)983-741324    Ice D
  34.     Arcadia        +44-(0)923-893593    Beast
  35.         EnterPrise      +01-4122332611          Picard
  36.  
  37.  Why Use TTOP instead of your top uploader util??
  38.  ------------------------------------------------
  39.  Well, aside from looking cool and having all the features that most sysops
  40.  want these days, it is fucking amazingly fast! Compare it to Ulog for
  41.  example and you will see the difference!!  The main reason this util is so
  42.  much faster is because its coded in a REAL language! None of this pussy shit
  43.  Basic or C. It has been tested fully on our worldwide boards with absolutely
  44.  NO problems what-so-ever. TOTALLY BUG FREE (!). A small problem with the
  45.  first release was that it would not work on all cache memory systems but
  46.  this was only due to the code being encoded to stop lamers getting at my 
  47.  hard work. Ive now taken this out and hope that they will have the sense
  48.  not to fiddle about with any of the enclosed texts etc. Thanks must go to
  49.  DreamMaster & N.O.M.A.D from the Living Hell BBS for pointing this out to
  50.  me. These were the only sysops who actually bothered to tell me. See - let
  51.  me know and it can be sorted! The other change to this version is that you
  52.  can now also display a TOP LEECHERS CHART if you wish. (see command info)
  53.     Right, I'll start off for with a small description of the command
  54.  line and then go on to some examples which hopefully will help you all
  55.  understand it a bit better.
  56.  
  57.  Main Command Line
  58.  -----------------
  59.  
  60. T-TOP >OUTPUT L(C) S:TLOGO S T BBS:USER.DATA ###/ALL # L(C) S:BLOGO 
  61. --1-- ---2--- ------3----- 4 -------5------- ---6--- 7 ------8-----
  62.  
  63. +---+---------------------------------------------------------------------+
  64. | # | Description                                                         |
  65. +---+---------------------------------------------------------------------+
  66. | 1 | Utils Path/Name                                                     |
  67. +---+---------------------------------------------------------------------+
  68. | 2 | Redirect to the output file. Use two >'s to JOIN to existing file.  |
  69. |   | Remove this argument to send the output straight to your CLI...     |
  70. +---+---------------------------------------------------------------------+
  71. | 3 | Logo Above the Chart. Use its FULL path. Remove this argument to    |
  72. |   | have no logo at the top. Add another of this Argument to have 2 or  |
  73. |   | more logos at the top. The number of logos is infinite! From version|
  74. |   | 1.03 onwards you can now use "LC" to output logo but TTOP will clear|
  75. |   | the screen beforehand for ya.                                       |
  76. +---+---------------------------------------------------------------------+
  77. | 4 | Add an S before Arg 5 to strip the |'s from the output. This will   |
  78. |   | make the output look much better when viewed through Ami-Express's  |
  79. |   | ANSI stripper. If you're making the ANSI version, leave this arg    |
  80. |   | out. NOTE: The non-ansi output does not bother stripping the ANSI   |
  81. |   | codes, as Express will do this fine by itself.                      |
  82. +---+---------------------------------------------------------------------+
  83. | 5 | Specify the FULL name and path of your user.data here. Leave this   |
  84. |   | Arg out to turn the util into a glorified Type command!! You can    |
  85. |   | define a "D" instead of the "T" for a TOP LEECHERS CHART!           |
  86. +---+---------------------------------------------------------------------+
  87. | 6 | Specify how many users to include on the chart. MUST be a 3 digit   |
  88. |   | number, so if it is less than 100 padding 0's must be added. EG 015 |
  89. |   | Enter "ALL" to list all of your users.                              |
  90. +---+---------------------------------------------------------------------+
  91. | 7 | Here you may place a number from 2-9. This number gets used in the  |
  92. |   | calculation to define Elite from Leeches. Ie 3 would give you about |
  93. |   | the same as most utils but you could use 9 to get less Elites and   |
  94. |   | Leeches but many more Normal users. If left out it defaults to 3    |
  95. +---+---------------------------------------------------------------------+ 
  96. | 8 | Same as Arg 3, except all logos after Arg 5 (User.Data) will go     |
  97. |   | BELOW the actual Chart.                                             |
  98. +---+---------------------------------------------------------------------+
  99.  
  100.  Ha! bet you're all still a bit baffled eh?  Maybe these will help...
  101.  
  102.  Some Examples
  103.  -------------
  104.  L (LOGO) - Defines that the following file is text to be displayed above
  105.             (position 3) or below (position 8) the user data chart. By
  106.             leaving out the user data parts of the command line, it can
  107.             be used as a glorified type command. (REMEMBER TO GIVE A RE-
  108.             DIRECTION FILE IF REQUIRED!). As many texts as you want can
  109.             be displayed before or after the user chart. For new option
  110.             see "New to 1.03" near the end of the doc file.
  111.              
  112.  EXAMPLE:
  113.  TTop l bbs:logos/logo1
  114.  TTop l bbs:logos/logo1 l bbs:logos/adtext
  115.  
  116.  
  117.  S (STRIP) - When the user chart is displayed all "|"'s are stripped
  118.             out for you so it looks better through Ami-Expresses Ansi-
  119.          stripper. It does NOT strip ansi codes cause express can
  120.          handle this for you. This argument must come BEFORE the
  121.          user.data file. If left our it will default to ansi-display.
  122.  
  123.  T (TOP!) - This argument tells TTop that the following path and file
  124.          are to be used to extract the user data from to compile the
  125.          chart. After the file name leave a space followed by a 3
  126.          digit number which will define how many users you wish to
  127.          be displayed in the chart. The number must be decimal and
  128.          if the users required is below 100 padding zeros MUST be 
  129.          added. This number can be replaced by "all" or just an "a"
  130.          to give stats for all users.
  131.  D (DOWN) - Same as above option except that a downloaders chart will be
  132.          displayed instead of the usual uploaders.
  133.  
  134.  EXAMPLE:
  135.  TTop t bbs:data/user.data 010        Display top 10 data
  136.  TTop t bbs:data/user.data 025        Display top 25 data
  137.  TTop d bbs:data/user.data all        Display all users download data
  138.  
  139.         After this 3 digit figure you can place a decimal number between
  140.         3 & 9. This gets used in a multiplication routine that decides 
  141.         which sort of ratios get classed as elite,leech or normal. For
  142.         example 3 will give ratios of 3/1 7 would give 7/1 etc. If left
  143.         out TTop will use its own default of 3.
  144.         
  145.  EXAMPLE:
  146.  TTop t bbs:data/user.data 010 5    Display top 10 data ratios 5/1
  147.  TTop t bbs:data/user.data 025        Display top 10 data ratios 3/1
  148.  
  149.  
  150.  MAIN EXAMPLES:
  151.  -------------
  152.        There now follows some examples that put all of the above into
  153.        practice just to get you into the swing of things. Dont forget
  154.        to add the re-direction.
  155.  
  156.        1) Display group logo then user chart for top 10 users using
  157.           a ratio of 3/1.
  158.  
  159. TTop l bbs:logos/logo1 t BBS:USER.DATA 010
  160.  
  161.        2) Display group logo, small add for another board then top
  162.           15 users using a ratio of 5/1
  163.  
  164. TTop l bbs:logos/logo1 l bbs:ads/adtext1 t bbs:user.data 015 5
  165.  
  166.        3) Same as above but with advert after the user chart.
  167.  
  168. TTop l bbs:logos/logo1 t bbs:user.data 015 5 l bbs:ads/adtext1
  169.  
  170.        4) Display uploader chart for all users using 9/1 ratio (tough!)
  171.           but strip out ansi crap.
  172.  
  173. TTop s t bbs:user.data a 9
  174.  
  175.        Hopefully you can use all options by now so have fun and compare
  176. the speed of TTOP to the old util you were using!!!
  177.  
  178.  
  179. **************************************************************************
  180. *             Update Information from Version 1.01+                      *
  181. **************************************************************************
  182.  
  183.  New to 1.03
  184.  -----------
  185.  It only a small update but people have asked for it. If at the logo
  186.  command you DIRECTLY follow the "L" with a "C" then TTOP will now clear
  187.  the screen before displaying your text/logo.
  188.  
  189.  EXAMPLE:
  190.  
  191. TTop lc bbs:logos/logo1
  192.  
  193. **************************************************************************
  194.  New to 1.04
  195.  -----------
  196.  Just a small bug-fix. Thanks to Beast from Arcadia for the info.
  197.  On the overall user stats line the Megs up/downloaded would overflow
  198.  to soon for many bbs's. The calculation has now been improved and will
  199.  now not overflow until Ami-Express's user-data structure itself overflows.
  200.  
  201.     Look out for TBAR coming soon.. All charts available ie Ups/downs
  202.     Msgs,files etc.. all in a FAST bar chart format. And then .....
  203.     ThrashTop V2  - ideas NOW!!!
  204.  
  205. **************************************************************************
  206.  New to 1.05
  207.  -----------
  208.  Requested/Needed! by a few of the larger boards who use my utils. TTop
  209.  will now handle 10 figures in the bytes area of the ansi chart. This
  210.  means that people/s who have uploaded more than 1 Gig will now have
  211.  the correct number of bytes next to their name. Sorry for not doing this
  212.  in previous versions but i was unaware their were so many hot guys out
  213.  there!!
  214.  
  215. **************************************************************************
  216.  
  217.  Last note
  218.  ---------
  219.         I will give be doing fairly(!) regular updates to this util but
  220.  cant do anything special unless sysops are prepared to give me their own
  221.  ideas etc. (One we've been chatting about is random logos. ie you give TTop
  222.  a choice of maybe upto 10 logos and the util will pick one!).  I dont mind
  223.  adding stuff but you must let me get some sort of feedback.  I s'pose that
  224.  will have to include moans ,bugs (NONE!) as well!  Just leave a message to
  225.  Thrash on our UKHQ (C.A.L +44-81-3466842), or maybe Im on your board
  226.  already (You lucky person!).
  227.  
  228.                                Thrash/Nudel'92
  229.  
  230.  PS: Dont fuckin try getting you mitts on the text!! You want your own text
  231.      in a util, learn to fuckin code!! This is our work so leave it alone.
  232.      If you fancy a go at changing anything - beware! YOU HAVE BEEN WARNED